package com.education.ai.service;

import com.education.ai.entity.AbilityAssessment;

import java.util.List;
import java.util.Map;
import java.util.Optional;

/**
 * 能力评估服务接口
 */
public interface AbilityAssessmentService {
    
    /**
     * 获取所有能力评估
     */
    List<AbilityAssessment> getAllAssessments();
    
    /**
     * 根据ID获取能力评估
     */
    Optional<AbilityAssessment> getAssessmentById(Long id);
    
    /**
     * 根据学生ID获取能力评估
     */
    List<AbilityAssessment> getAssessmentsByStudentId(String studentId);
    
    /**
     * 根据学科获取能力评估
     */
    List<AbilityAssessment> getAssessmentsBySubject(String subject);
    
    /**
     * 根据学生ID和学科获取能力评估
     */
    List<AbilityAssessment> getAssessmentsByStudentIdAndSubject(String studentId, String subject);
    
    /**
     * 获取学生在某学科的最新评估
     */
    Optional<AbilityAssessment> getLatestAssessment(String studentId, String subject);
    
    /**
     * 保存能力评估
     */
    AbilityAssessment saveAssessment(AbilityAssessment assessment);
    
    /**
     * 删除能力评估
     */
    void deleteAssessment(Long id);
    
    /**
     * 获取学科能力评估的统计数据
     */
    Map<String, Double> getSubjectAssessmentStatistics(String subject);
    
    /**
     * 生成学生能力评估（使用AI）
     */
    AbilityAssessment generateAssessment(String studentId, String subject);
} 